package com.nanjia.boot.delivery.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.nanjia.boot.delivery.model.entity.Certificate;
import com.nanjia.boot.delivery.model.form.CertificateForm;
import com.nanjia.boot.delivery.model.query.CertificateQuery;
import com.nanjia.boot.delivery.model.vo.CertificateVO;

/**
 * 证件服务类
 *
 * @author 周洋
 * @since 2025-06-13 11:09
 */
public interface CertificateService extends IService<Certificate> {

    /**
     *证件分页列表
     *
     * @return {@link IPage<CertificateVO>} 证件分页列表
     */
    IPage<CertificateVO> getCertificatePage(CertificateQuery queryParams);

    /**
     * 获取证件表单数据
     *
     * @param id 证件ID
     * @return 证件表单数据
     */
     CertificateForm getCertificateFormData(Long id);

    /**
     * 新增证件
     *
     * @param formData 证件表单对象
     * @param ipAddr
     * @return 是否新增成功
     */
    boolean saveCertificate(CertificateForm formData, String ipAddr);

    /**
     * 修改证件
     *
     * @param id   证件ID
     * @param formData 证件表单对象
     * @return 是否修改成功
     */
    boolean updateCertificate(Long id, CertificateForm formData);

    /**
     * 删除证件
     *
     * @param ids 证件ID，多个以英文逗号(,)分割
     * @return 是否删除成功
     */
    boolean deleteCertificates(String ids);

}
